palette

Type

command

Summary

Opens a stack in a palette window.

Syntax

palette <stack>

Description

Use the palette command to display a stack in a palette window.

Use palette windows to display tools or information about main windows.

A palette window behaves like an ordinary window, except that its appearance is different, with a narrower title bar. If the raisePalettes property is set to true, any palettes float in their own layer, above all ordinary windows. palettes cannot be resized or edited. To edit a palette, use the topLevel command to display it in an editable window.

The palette command closes the stack and reopens it as a palette, so closeStack and openStack, closeCard and openCard, and (if applicable) closeBackground and openBackground messages are sent to the current card as a result of executing this command. Use the lock messages command before executing palette if you want to prevent the close messages from being sent; the open messages are sent regardless of the setting of the lockMessages property.

If the stack is already displayed as a palette, the palette command does not close and reopen it.

The Browse tool is always used in palette windows, regardless of the current setting of the tool property.

Parameters

Name	Type	Description
stack		Any stack reference.

Examples

palette stack "Tools"

palette the defaultStack

Related

command: topLevel, lock messages, modeless, palette

glossary: property, current card, palette, execute, message, editable window, command

message: openCard, closeStack, closeCard, closeBackground, openStack, openBackground

object: stack

property: hidePalettes, activatePalettes, lockMessages, layer

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

Platforms

desktop

server